HiddenPro AI Desktop App
========================

HiddenPro AI is a portable desktop assistant for chat, screenshots, voice, and meeting-note workflows. Sign in with the same HiddenPro account you use on the web dashboard and start working immediately.

Windows (Portable)
------------------
Go to https://app.hiddenproai.online/dashboard and sign in.
Click Download for Windows (ZIP).
Extract the ZIP to a folder (for example: Desktop\HiddenPro AI).
Open the folder, right-click HiddenPro AI.exe, then click Run as administrator.
If Windows SmartScreen appears, click More info -> Run anyway.
Allow requested permissions (Microphone, Screen/Screenshot, etc.).
Add the app folder to your antivirus allow list (recommended).
Sign in with your HiddenPro account and start using it.

Disabling Windows Defender Firewall
-----------------------------------
Press the Windows key and type "Windows Defender Firewall" then select the app from the search results.
In the left sidebar, click "Turn Windows Defender Firewall on or off".
Under both "Private network settings" and "Public network settings", select "Turn off Windows Defender Firewall"
Click "OK" to apply the changes.

Disabling Windows Defender (Real-time Protection)
-------------------------------------------------
Press the Windows key and type "Windows Security" then open the app.
Click on "Virus & threat protection" in the left menu.
Under "Virus & threat protection settings", click "Manage settings".
Toggle off "Real-time protection". You may need to confirm with admin privileges.

Windows notes
-------------
- The app is a portable Windows build, so you can extract it and run it without a traditional installer.
- Running as administrator is recommended because the desktop app uses system capture, microphone access, global shortcuts, and window-management features.
- The main log file is api.log, stored next to the executable.
- Shortcut bindings can be changed later from Settings.
- On Windows, many shortcuts are also registered as global hotkeys, so they can continue working even when the main window is not focused.

Recommended Windows security setup
----------------------------------
Do not disable Windows Defender Firewall or Windows Security for the whole machine just to run the app. That is broader than necessary and weakens the system.

Use these safer steps instead:
1. Verify the publisher or digital signature on the executable if Windows shows a trust prompt.
2. Keep the app in a normal trusted folder such as Desktop\HiddenPro AI or C:\Apps\HiddenPro AI.
3. If your antivirus or EDR blocks the app, add the app folder or "HiddenPro AI.exe" to that product's allow list if your organization permits it.
4. If Windows Firewall asks whether to allow the app, allow HiddenPro AI instead of turning the firewall off globally.
5. If a corporate security product still blocks launch or audio capture, send api.log to support so the exact failure can be reviewed.

First run checklist
-------------------
- Run the executable as administrator so Windows grants the desktop permissions the app needs.
- Confirm microphone and screenshot permissions when prompted.
- Downloaded portable build: microphone and system audio work with no extra installs (DLLs are in the app folder).
- Developers: run python build_portable.py to bundle audio_capture.dll automatically.
- Open Settings after sign-in to review audio devices, AI provider preferences, and profile settings.
- Review your shortcut bindings in Settings if you want to avoid conflicts with other tools.
- Keep api.log with the app folder for troubleshooting.

Core features
-------------
- Ask Anything: Type your prompt, press Enter to send, and read the streamed answer in the output panel.
- Screenshots and Vision: Capture one or more screenshots, write a prompt, and process them together.
- Voice and System Audio: Use Mic for microphone capture (sounddevice) or System Audio for speaker loopback (Rust DLL).
- Meeting Notes: Record, transcribe, and summarize meetings. With an updated audio_capture.dll, captures mic + system audio together.
- Personalization: Add a short resume or profile in Settings for more tailored answers.

Windows shortcuts
-----------------
These are the default Windows shortcuts defined in the app. They can be changed in Settings.

Core actions
------------
- Ctrl+Shift+A: Ask using the current prompt
- Ctrl+Shift+S: Capture screenshot
- Ctrl+Shift+Backspace: Clear staged screenshots
- Ctrl+Shift+D: Process uploaded screenshots
- Ctrl+Shift+R: Start or stop microphone capture
- Ctrl+Shift+O: Start or stop system-audio capture
- Ctrl+Shift+N: Start or stop meeting notes recording
- Ctrl+N: Start a new chat
- Ctrl+Q: Quit the app
- Ctrl+L: Logout
- Ctrl+Shift+M: Minimize or restore the main window
- Enter: Send message from the input box
- Shift+Enter: Insert a new line in the input box

Main window movement
--------------------
- Ctrl+Alt+Left: Move the main window left
- Ctrl+Alt+Right: Move the main window right
- Ctrl+Alt+Up: Move the main window up
- Ctrl+Alt+Down: Move the main window down

Output window movement
----------------------
- Ctrl+Alt+Shift+Left: Move the output window left
- Ctrl+Alt+Shift+Right: Move the output window right
- Ctrl+Alt+Shift+Up: Move the output window up
- Ctrl+Alt+Shift+Down: Move the output window down

Toolbar actions
---------------
- Mic: microphone recording and voice answer flow
- System Audio: capture and analyze system playback audio
- Screenshot: capture the current display
- Process Photo: analyze staged screenshots with your prompt
- Meeting Notes: start or stop meeting-note recording from the toolbar
- Minimize: hide or restore the app quickly

Settings overview
-----------------
- Providers and model presets: choose the AI provider and model profile.
- Audio devices: choose the microphone and speaker devices.
- Resume / profile: provide personal context for interview or profile-style answers.
- Language preferences: set the default programming language for examples.
- Voice tuning: adjust sensitivity, gain, and related audio behavior.

Logs and support
----------------
- Windows log file: api.log next to the executable.
- macOS log file: ~/Library/Logs/HiddenPro AI/api.log
- Support email: info@hiddenproai.online

When reporting a launch or API problem, include the relevant api.log file.

For Windows launch issues, include:
- what happened on launch
- whether SmartScreen or antivirus blocked the app
- whether you ran HiddenPro AI.exe as administrator
- the relevant api.log

Apple devices
-------------
- macOS is supported through the portable .app zip build.
- iPhone and iPad are not supported by the desktop app. Use the web experience instead.

Billing
-------
- Upgrade to Premium through secure Stripe Checkout in your browser.
- Paid users can open the billing portal from the app.
- Use Refresh in the app to sync billing status without restarting.
